home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmnameindom.z / pmnameindom
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNAAAAMMMMEEEEIIIINNNNDDDDOOOOMMMM((((3333))))                                                  PPPPMMMMNNNNAAAAMMMMEEEEIIIINNNNDDDDOOOOMMMM((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmNNNNaaaammmmeeeeIIIInnnnDDDDoooommmm - translate an instance identifier into an instance name
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      iiiinnnntttt ppppmmmmNNNNaaaammmmeeeeIIIInnnnDDDDoooommmm((((ppppmmmmIIIInnnnDDDDoooommmm iiiinnnnddddoooommmm,,,, iiiinnnntttt iiiinnnnsssstttt,,,, cccchhhhaaaarrrr ********nnnnaaaammmmeeee))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      For the instance domain _i_n_d_o_m, in the current Performance Metrics
  20.      Application Programming Interface (PMAPI) context, locate the instance
  21.      with the internal instance identifier given by _i_n_s_t, and return the full
  22.      external instance identification via _n_a_m_e.
  23.  
  24.      The value for the instance domain _i_n_d_o_m is typically extracted from a
  25.      _p_m_D_e_s_c structure, following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular
  26.      performance metric.
  27.  
  28.      The space for the value of _n_a_m_e will have been allocated in ppppmmmmNNNNaaaammmmeeeeIIIInnnnDDDDoooommmm
  29.      with mmmmaaaalllllllloooocccc(3C), and it is the responsibility of the caller to ffffrrrreeeeeeee(3C)
  30.      the space when it is no longer required.
  31.  
  32.      ppppmmmmNNNNaaaammmmeeeeIIIInnnnDDDDoooommmm returns zero on success.
  33.  
  34. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  35.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3) and ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmm(3).
  36.  
  37. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  38.      PPPPMMMM____EEEERRRRRRRR____IIIINNNNDDDDOOOOMMMM
  39.           _i_n_d_o_m is not a valid instance domain identifier
  40.  
  41.      PPPPMMMM____EEEERRRRRRRR____IIIINNNNSSSSTTTT
  42.           The instance identifier _i_n_s_t is not known for the instance domain
  43.           _i_n_d_o_m in the current PMAPI context
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.